home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir40 / lgroom.zip / README.1ST < prev    next >
Text File  |  1993-11-01  |  19KB  |  459 lines
  1.                     
  2.       ╔═════════════════════════════════════════════════════════╗
  3.       ║ THIS DOCUMENTATION GOES WITH VERSION 2.0 OF LEGROOM(tm) ║
  4.       ╚═════════════════════════════════════════════════════════╝
  5.  
  6.               _______
  7.          ____|__     |               (R)
  8.       --|       |    |-------------------         Thanks,
  9.         |   ____|__  |  Association of
  10.         |  |       |_|  Shareware                 Phil Grenetz
  11.         |__|   o   |    Professionals             Ivden Technologies, Inc.
  12.       -----|   |   |---------------------
  13.            |___|___|    MEMBER
  14.  
  15.  
  16.  ==============================================================================
  17.                     
  18.                     TABLE OF CONTENTS                       
  19.                     ─────────────────
  20.  
  21. 1. SHAREWARE CONCEPT
  22.  
  23. 2. ACKNOWLEDGMENTS
  24.  
  25. 3. PACKING LIST
  26.  
  27. 4. WHAT IS LEGROOM?
  28.  
  29. 5. HOW TO USE LEGROOM
  30.  
  31. 6. USAGE NOTES
  32.  
  33. 7. DISCLAIMER
  34.  
  35. 8. DISTRIBUTION POLICY AND LICENSE
  36.  
  37. 9. ON-LINE, HYPERTEXT VERSION OF THIS README DOCUMENT
  38.  
  39.  
  40. 1. SHAREWARE CONCEPT
  41. ────────────────────
  42.  
  43. "Shareware" is a term used to describe a system for distribution of
  44. software.  Under the shareware concept, software may be freely
  45. copied and passed along to others, or distributed through bulletin
  46. board systems, shareware distribution companies, etc.
  47.  
  48. As a recipient of a shareware program, you may use the software for
  49. a short trial period to determine if it meets your needs.  If it
  50. does, you pay the registration fee.  By paying the fee, you are
  51. granted the right to retain the software for your use.  If the
  52. software is not suitable, then you may discard it.
  53.  
  54. The shareware system provides substantial benefits to the computing
  55. community (of which YOU are a member):
  56.  
  57.  
  58.  a) You get to try out the software BEFORE you buy it so you know
  59.     exactly what you're buying.
  60.  
  61.  b) Shareware is substantially less expensive than most commercial
  62.     programs.  You don't pay for costly marketing programs and
  63.     fancy packaging.
  64.  
  65.  c) You get access to a MUCH broader base of available programs.
  66.     Thousands of excellent programs have been written by expert
  67.     programmers who would never consider marketing commercially.
  68.  
  69. Through the concept of shareware, these people make their
  70. programs available to the community.  Usually, all they ask in
  71. return is a small fee to reward them for the time and effort
  72. they've put into the program.
  73.  
  74. The system is based entirely on the honor system, and generally
  75. works quite well.  (Most people are honest and wouldn't violate the
  76. trust placed in them by the author of the software.)
  77.  
  78. Shareware is NOT free software - the author counts on your
  79. integrity. Please register using the form in the file REGISTER.FRM.
  80.  
  81. You are encouraged to copy this software and pass it along to
  82. others who may be interested in using it.
  83.  
  84. In exchange for registering your copy of LegRoom(tm), you will
  85. receive the current version without the registration reminder and
  86. the next version of LegRoom (tm) when it is available.
  87.  
  88. In addition, you will receive a listing of other Ivden products.
  89.  
  90.  
  91. 2. ACKNOWLEDGMENTS
  92. ──────────────────
  93.  
  94. LegRoom(tm) was developed by Phil Grenetz and is published by
  95. Ivden Technologies, Inc. as part of a line of memory resident
  96. utilities.
  97.  
  98.                (c) Copyright 1992-93 Phil Grenetz
  99.  
  100. The hypertext documentation was developed using the authoring system 
  101. DeskTop Advisor(tm), also published by Ivden Technologies, Inc.
  102.  
  103.  
  104. 3. PACKING LIST
  105. ───────────────
  106.  
  107. LEGROOM.EXE         Executable File
  108. REGISTER.FRM        Registration Form
  109. README.1ST          Conventional Documentation File
  110. UPDATE.DOC          Release History (changes since initial version)
  111. VENDOR.DOC          Shareware Vendor Distribution Policy Statement
  112. SUPPORT.DOC         Tech Support Policy and ASP Ombudsman Statement
  113. DA_BROWS.EXE        DeskTop Advisor (DA) Hypertext Browser
  114. DA_?.HLP            DA help files (1 to 5)
  115. LROOM.DTA           Hypertext Documentation File
  116. LROOM.MAP                "         "         "
  117. LROOM.WDX                "         "         "
  118. LROOM.XRF                "         "         "
  119. LROOM.WLK                "         "         "
  120. LROOM.TWX                "         "         "
  121. LROOM.CWD                "         "         "
  122.  
  123.  
  124. 4. WHAT IS LEGROOM?
  125. ───────────────────
  126.  
  127. LegRoom(tm) is published by Ivden Technologies, Inc. as part of its
  128. line of memory resident utilities.  LegRoom was designed to solve
  129. two problems:
  130.  
  131.  a) shelling to DOS from programs that don't have a DOS shell
  132.     function
  133.  
  134.  b) shelling from programs whose shell function gives too little
  135.     memory at the DOS prompt to do any useful work.
  136.  
  137. LegRoom(tm) allows you to Shell to DOS from any text and most
  138. graphic  applications.  It loads as a TSR (Terminate and Stay
  139. Resident) program and is triggered when you press a hot key.
  140.  
  141. Version 2.0 now lets you make any program (even a DOS batch file)
  142. pop up as a TSR when you press the hot key.
  143.  
  144.  
  145. 5. HOW TO USE LEGROOM
  146. ─────────────────────
  147.  
  148. LegRoom(tm) runs on any IBM compatible computer running MS-DOS,
  149. Version 2.0 and up, or 100% compatible operating system.
  150.  
  151. Load LegRoom(tm) by entering the command LEGROOM from the directory
  152. where you installed it.  You can also add that command to your
  153. AUTOEXEC.BAT file to load LEGROOM whenever you boot your computer.
  154. That way, it will stay in memory for use whenever you need it.
  155.  
  156. LegRoom(tm) auto-detects the presence of extended and expanded
  157. memory and takes advantage of them.  If available, it loads itself
  158. into expanded memory, taking up less than 2 KB of conventional memory.
  159.  
  160. When you press the hot key, the current application is suspended.
  161. It is moved to a holding area in extended memory, expanded memory,
  162. or your hard disk, depending on which is available.
  163.  
  164. The program, its data, video memory, mouse state, floating point
  165. coprocessor state, etc. are saved, as are your current drive and
  166. directory.
  167.  
  168. When you are finished running other programs, type EXIT to return to
  169. the suspended application.  Its state is restored to that saved prior
  170. to pressing the hot key.
  171.  
  172. You needn't have an expanded memory board to have expanded memory.
  173. Memory managers such as EMM386, QEMM386, and 386MAX emulate
  174. expanded memory for applications which call for it.
  175.  
  176. There are six command line parameters you can use to control the
  177. behavior of LegRoom(tm).  These parameters are described below:
  178.  
  179.           LEGROOM  [/D | /N]  [/H=n]  [/R=p]  [/U]  [/?],
  180.  
  181. where:
  182.        /D   creates a temporary disk file for holding the current
  183.             application, instead of using extended or expanded memory
  184.  
  185.        /N   uses extended memory, if available, for holding the
  186.             current application, but DOES NOT use expanded memory
  187.             (this makes it run compatibly with QEMM in 'stealth' mode
  188.              and the NetWare driver EMSNET)
  189.  
  190.        /H=n changes the default hot key from Ctrl-Shift-0 to
  191.             Ctrl-Shift-n, where n is between 0 and 9
  192.  
  193.        /R=p causes any program or DOS batch file to be run when the
  194.             hot key is pressed (p is the complete path and file
  195.             specification (including .exe, .com, or .bat extension)
  196.             and optional command line
  197.  
  198.        /U   unloads LegRoom(tm) from memory (you cannot unload it when
  199.             you have shelled to DOS using it)
  200.  
  201.        /?   displays help information without loading LegRoom(tm).
  202.  
  203. To trigger LegRoom(tm), press the default hot key or the hot key
  204. you requested if you used the /H=n parameter as described above.
  205. Use the standard number keys on your keyboard, NOT THE NUMERIC
  206. KEYPAD.
  207.  
  208.  
  209. 6. USAGE NOTES
  210. ──────────────
  211.  
  212. You can load LegRoom(tm) into upper memory with the "load high"
  213. facilities of a memory manager.  This saves a small amount of
  214. conventional memory.  The amount of the savings is greater when using
  215. the /N or /D switch.  These switches prevent a 386 based memory
  216. manager from loading most of LegRoom(tm) into expanded memory.
  217.  
  218. Ctrl-Break is disabled at the new DOS prompt after triggering
  219. LegRoom(tm).  Use Ctrl-C instead of Ctrl-Break to break out of a
  220. process launched from the new DOS prompt.
  221.  
  222. DON'T SHELL FROM A SHELL!  If you loaded LegRoom without the /R=
  223. switch, you cannot trigger LegRoom(tm) when at the DOS prompt.  This
  224. would be a waste of memory or disk space.  However, LegRoom(tm) does
  225. not detect the presence of a DOS prompt created by using a program's
  226. built-in shell feature.  Use one or the other, but not both.
  227.  
  228. You can use LegRoom(tm) from multitasking environments such as
  229. DesqView and Microsoft Windows.  The advantages of LegRoom(tm) are
  230. greatest in a single tasking DOS environment.  If you decide to use
  231. LegRoom in a multitasking environment, be sure to load it from within
  232. a DOS 'box' or DOS 'window', NOT before entering the environment!
  233.  
  234. Do not use LegRoom(tm) to shell from a communication program while
  235. transferring data.  Shelling with LegRoom(tm) suspends the current
  236. application.  It does NOT keep running in the background.  Data will
  237. be lost if you use LegRoom(tm) to shell to DOS while performing a
  238. file transfer.
  239.  
  240. You should, in general, not load a TSR into memory when you have
  241. shelled to DOS from an application.  When you exit the application,
  242. your conventional memory pool has a 'hole' where the application was.
  243. This is called fragmentation.  It reduces the largest block of memory
  244. available to programs.
  245.  
  246. If you use LegRoom to make a batch file act as a TSR, add the
  247. following line to the end of the batch file:  EXIT
  248.  
  249. If it is necessary for LegRoom(tm) to create a swap file, it is
  250. identified by the LR_SWAP environment variable.  It is recommended
  251. that you set this variable in your AUTOEXEC.BAT file so that it is set
  252. automatically whenever you boot your computer.  Otherwise, the swap
  253. file is stored in a subdirectory named 'TEMP' under the directory
  254. where you installed LegRoom(tm).
  255.  
  256. The swap file is stored with System and Read-Only attributes to reduce
  257. the risk of deletion or renaming while LegRoom(tm) is loaded.
  258.  
  259. LegRoom(tm) supports any number of concurrent users on a network.
  260. Each user should be assigned a unique swap file in his/her LR_SWAP
  261. environment variable to avoid 'collisions'.  Similarly, if you use
  262. LegRoom in multiple DOS sessions in DesqView or Microsoft Windows,
  263. and expect it to use disk space for swapping, set LR_SWAP to a
  264. different directory in each session before loading LegRoom.
  265.  
  266. Each time LegRoom is loaded, the old swap file (if any) is replaced by
  267. a new one.  The old swap file is also removed on unloading LegRoom.
  268. Rebooting or turning off the computer without first unloading
  269. LegRoom(tm) results in the current swap file remaining on the disk.
  270.  
  271. LegRoom(tm) supports all standard graphic adapters and modes as well
  272. as Super VGA modes up to a maximum video memory requirement of 256 KB.
  273.  
  274.  
  275. 7. DISCLAIMER
  276. ─────────────
  277.  
  278. IVDEN TECHNOLOGIES, INC. (IVDEN) HEREBY DISCLAIMS ALL WARRANTIES
  279. RELATING TO THIS SOFTWARE, WHETHER EXPRESS OR IMPLIED, INCLUDING
  280. WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
  281. FITNESS FOR A PARTICULAR PURPOSE. IVDEN WILL NOT BE LIABLE FOR ANY
  282. SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SIMILAR DAMAGES DUE
  283. TO LOSS OF DATA OR ANY OTHER REASON, EVEN IF IVDEN OR AN AGENT OF
  284. IVDEN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  IN NO
  285. EVENT SHALL IVDEN'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE
  286. PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM OF
  287. THE CLAIM.  THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE
  288. QUALITY AND PERFORMANCE OF THE SOFTWARE.
  289.  
  290.  
  291. 8. DISTRIBUTION POLICY AND LICENSE
  292. ──────────────────────────────────
  293.  
  294. Distribution Policy
  295. ───────────────────
  296.  
  297.    ANYONE DISTRIBUTING LEGROOM FOR ANY KIND OF REMUNERATION MUST FIRST
  298.    CONTACT IVDEN TECHNOLOGIES, INC. FOR AUTHORIZATION AT THE FOLLOWING
  299.    ADDRESS:
  300.  
  301.                   Ivden Technologies, Inc.
  302.                   87 Arbor Road
  303.                   Churchville, PA 18966-1007
  304.  
  305.    This authorization will be automatically granted to distributors
  306.    recognized by the ASP as adhering to its guidelines for shareware
  307.    distributors, and such distributors may begin offering LegRoom
  308.    immediately. However, Ivden Technologies, Inc. must still be
  309.    advised so that the distributor can be kept up-to-date with the
  310.    latest version of LegRoom.
  311.  
  312.  
  313. License to Use LegRoom(tm)
  314. ──────────────────────────
  315.  
  316. LegRoom(tm) is a copyrighted software package. It is being 
  317. distributed as user supported shareware. By using or distributing 
  318. this package, you agree to the following:
  319.  
  320. You are granted a limited license to try this program, LegRoom(tm),
  321. for 30 days. If you find this software useful and wish to continue 
  322. using it after the 30 day evaluation period, you must pay the 
  323. registration fee.  Registration for use on a single personal computer 
  324. is $35.00.  You may, instead, register for installation on a local 
  325. area network (LAN) server.  The LAN registration fee of $99 permits 
  326. an unlimited number of concurrent users on the registered server.
  327.  
  328. Register for each personal computer and each LAN server on which 
  329. LegRoom(tm) is installed.  To register, fill out the registration 
  330. form (see REGISTER.FRM) and send it or a note with the registration 
  331. fee.
  332.  
  333. No other license or rights are granted by implication or otherwise.
  334. After evaluating LegRoom(tm), if you continue to use it, you MUST
  335. register.
  336.  
  337.  
  338. NOTE TO DEVELOPERS:
  339. If you would like to seamlessly integrate the LegRoom(tm) technology
  340. into programs you distribute for profit, Ivden Technologies, Inc.
  341. maintains an interrupt-triggered version.  The developer version of
  342. LegRoom(tm) loads in advance of your program and resides in memory
  343. as an interrupt service routine dedicated to your program(s).  You 
  344. just call a specified interrupt and the DOS shell is triggered.  
  345.  
  346. No saving / restoring your screen.  No worrying about how little 
  347. memory will available for your 'child' program or at the DOS prompt.
  348. LegRoom(tm) takes care of everything.  No link libraries to bother
  349. with.  No memory models or compatibility issues to hassle with.
  350. Any language which has an interrupt call function is supported.
  351.  
  352. Contact Ivden Technologies, Inc. for our very reasonable runtime 
  353. license fee.
  354.  
  355.  
  356. 9. ON-LINE, HYPERTEXT VERSION OF THIS README DOCUMENT
  357. ─────────────────────────────────────────────────────
  358.  
  359. A hypertext Readme document is also provided with this package.
  360. It was created using another Ivden product, DeskTop Advisor(tm), 
  361. a hypertext document authoring system.
  362.  
  363. In DeskTop Advisor(tm), information is organized in topics.  From any
  364. topic, you can select other topics to explore by pressing Alt-T.
  365.  
  366. To browse the DeskTop Advisor(tm) documentation, change to the directory 
  367. on the disk where you installed LegRoom(tm).  Then enter the command:  
  368.                   
  369.                         DA_BROWS LROOM
  370.  
  371. from the DOS prompt.  The system will guide you from there.  It is 
  372. menu-driven and does not require a mouse.
  373.  
  374. Every time you visit a new topic, a bookmark is placed at the current
  375. topic.  No matter how deeply you go into the guide, you can retrace
  376. your steps, one topic at a time by pressing Ctrl-PgUp or pressing
  377. Alt-T and selecting ** PREVIOUS TOPIC **.  To return to the beginning
  378. of this document from any topic, press Ctrl-Home or press Alt-T and
  379. select ** INTRODUCTION **.
  380.  
  381.  
  382. The Master Topic Index
  383. ──────────────────────
  384.  
  385. You are not limited to using Alt-T for topic selection.  You can
  386. access any topic wherever you are in the document.
  387.  
  388. From any topic, you can view the master index of topics by pressing
  389. the Space Bar.  Next, using the PgUp, PgDn, arrow keys, and keys
  390. for the first letter of a topic, you can highlight a topic of
  391. interest.  Then, press Enter to proceed to the selected topic.
  392.  
  393. As always, you can return to the previously visited topic by pressing
  394. Ctrl-PgUp or pressing Alt-T and selecting ** PREVIOUS TOPIC **.
  395.  
  396.  
  397. Hyperlinks
  398. ----------
  399.  
  400. On any screen there may be key words (called 'hyperlinks') about which
  401. you would like to get more information.  By pressing the Tab key, you
  402. will make all such words appear highlighted.  The first hyperlink on
  403. the screen is blinking, indicating it is currently selected.
  404.  
  405. You can highlight a hyperlink in which you are interested by using
  406. the Tab, Home, and End keys.  Press Enter and a menu of topics
  407. which reference the hyperlinked word appears.  Select a topic which
  408. seems to be relevant to your needs.  That topic will pop up in a
  409. window.  Use the up and down arrow keys to view each page on which the
  410. word is used.
  411.  
  412. When finished viewing the selected topic, return to the underlying
  413. topic by pressing Ctrl-PgUp.  Select another related topic to
  414. explore or press ESCape to return to the underlying screen.
  415.  
  416.  
  417. Keyword Search
  418. --------------
  419.  
  420. You can perform a query from any topic to find all topics which
  421. relate to keywords of interest to you.  Press Alt-F, then Q to
  422. select Query from the Files menu.  As a shortcut, just press F2.
  423.  
  424. Now enter up to three keywords which describe an area of interest
  425. to you.  All topics which reference all the keywords will be
  426. retrieved, including the current topic.  Each additional keyword
  427. beyond the first serves to narrow the search, filtering out more
  428. irrelevant topics.
  429.  
  430. A menu of topics which satisfy your query will be presented.
  431. Select a topic and browse it using the PgUp and PgDn keys.
  432. When finished viewing the selected topic, return to the underlying
  433. topic by pressing Ctrl-PgUp.  Select another related topic to
  434. explore or press ESCape to return to the underlying screen.
  435.  
  436.  
  437. Self-Promotion
  438. --------------
  439.  
  440. DeskTop Advisor(tm) has a few other features, not included here, such
  441. as graphic images and sound overlays.  Sound Support(tm), a recorded 
  442. voice supplement to the standard help screens, is also included with 
  443. the product.  In addition, a DeskTop Advisor(tm) document can be made
  444. memory resident, to be triggered by a hot key as needed.
  445.  
  446.  
  447. Closing Word
  448. ------------
  449.  
  450. That's all there is to it!  We know LegRoom(tm) is so easy to use it 
  451. doesn't really need hypertext documentation.  But, we want as many 
  452. computer users as possible to be exposed to the concept.  We hope to make 
  453. DeskTop Advisor(tm) a standard tool for publishing on-line documentation 
  454. for software.  Thanks for trying it.  Your feedback is requested.
  455.  
  456. Of course, we hope you find that LegRoom(tm) makes your DOS environment
  457. more productive.  If you like the product, please register it.  If you
  458. have comments -- positive or negative -- please share them with us.
  459.